﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
	<link rel="Stylesheet" type="text/css" media="screen" href="Screen.css" />
  <title>STP_SetMstConfigName</title>
</head>
<body>
	<h3>STP_SetMstConfigName</h3>
	<hr />
<pre>
void STP_SetMstConfigName
(
    BRIDGE*       bridge,
    const char*   name,
    unsigned int  timestamp
);
</pre>
	<h4>
		Summary</h4>
	<p>
		Sets the Name field of the MST Configuration Identifier.</p>
	<h4>
		Parameters</h4>
	<dl>
		<dt>bridge</dt>
		<dd>Pointer to a BRIDGE object.</dd>
		<dt>name</dt>
		<dd>The new name. This must be a null-terminated string of up to 32 characters (up to 33 
			with the null-terminator).</dd>
		<dt>timestamp</dt>
		<dd>A timestamp used for the debug log. </dd>
	</dl>
	<h4>
		Remarks</h4>
		<p>
			This function may be called only for MSTP bridges (i.e., if <code>STP_VERSION_MSTP</code> was passed 
			to <a href="STP_CreateBridge.html">STP_CreateBridge</a> or
			<a href="STP_SetStpVersion.html">STP_SetStpVersion</a>).</p>
	<p>
		See §13.7 in 802.1Q-2011 for more information about the MST Configuration Identifier.</p>
	<p>
		If this function is not called, a default configuration name is used which is generated by
		<a href="STP_CreateBridge.html">STP_CreateBridge</a>. See the Remarks section there for 
		more information.</p>
	<p>
		See the Remarks section in STP_ResetMstConfigName for more information about the name of 
		the MST Configuration Identifier.</p>
	<p>
		This function may not be called from within an <a href="STP_CALLBACKS.html">STP callback</a>.</p>
	
</body>
</html>
